home *** CD-ROM | disk | FTP | other *** search
/ Amiga Tools 4 / Amiga Tools 4.iso / tools / disk-tools / harddisk / seeksame / seeksame.doc < prev    next >
Encoding:
Text File  |  1996-02-26  |  4.5 KB  |  153 lines
  1. SeekSame/SeekSame                SeekSame/SeekSame
  2.  
  3.      NAME
  4.  
  5.     SeekSame (Sesam) - seeks for same files and replaces superfluous
  6.                            copies by hardlinks
  7.  
  8.      VERSION
  9.  
  10.     $VER: SeekSame.doc v1.3 (7.11.95)
  11.  
  12.  
  13.      COPYRIGHT
  14.  
  15.     © 1994/95 Stephan Fuhrmann
  16.  
  17.     This program is SHAREWARE. If you use it, send 10 DM to the
  18.     author.
  19.  
  20.     Ideas, concepts and algorithms used in this program and the
  21.     included documentation may not be duplicated, changed, replaced
  22.     or reused.
  23.  
  24.  
  25.      WARNING
  26.  
  27.     SeekSame is a program that modifies data on your harddrives.
  28.     It's possible that it doesn't do the things it should do, in
  29.     some cases it could do more than it should. If you use it and
  30.     it does something unexpected and you loose, destroy or manipulate
  31.     data, software, hardware, health or something else that is or is
  32.     not valuable, don't ask me to compensate your loss. You've
  33.     been warned.
  34.  
  35.  
  36.      SYNOPSIS
  37.  
  38.     SeekSame DIR/A,ALL/S,DEL/S,MAKELINK/S,QUIET/S,VERBOSE/S
  39.  
  40.  
  41.      FUNCTION
  42.  
  43.     The purpose of this program is seeking equal files on
  44.     the harddisk and forcing the OS to reduce the redundant
  45.     files to a minimum. The result of this method is a gain
  46.     in free hard disk storage while the data are not being
  47.     compressed; the method is absolutely compatible and
  48.     requires no additional software out of OS 2.0.
  49.  
  50.     This command searches in the given directory for
  51.     files with equal contents and performs actions that
  52.     are adjusted to the filetype. In the easiest case this
  53.     is nothing - that's useful for checking the harddrive
  54.     for same files because SeekSame prints statistics containing
  55.     the possible freeable bytecount after each run. The next
  56.     variation is deleting all equal files but one - this is
  57.     useful for filecompilations like pictures. The most interesting
  58.     possibility is offered in combination with the Hardlinks of
  59.     the filesystem - with their help it's possible to delete
  60.     all same files but one and to create references at the place
  61.     of the deleted files to the file that's left. With this
  62.     method it's transparent for all programs and the OS whether
  63.     the files are the originals or their clones.
  64.  
  65.     The handling of hardlinks is given for the files: when
  66.     a hardlink or the file is deleted, all files are still
  67.     preserved until the last reference to the file as been
  68.     removed.
  69.  
  70.     There are 4 different passes:
  71.  
  72.     'Processing files' - every file on the harddisk is being
  73.             examined and global datas being remembered.
  74.             This is the most timeconsuming pass because
  75.             there usually must be read all contents of the
  76.             harddisk.
  77.  
  78.     'Generating table' - the remembered global datas are being
  79.             transcribed to a table.
  80.  
  81.     'Searching multiple occurances' - it's being searched for
  82.             same files and the userdefined actions
  83.             are being performed.
  84.  
  85.     'Cleanup' - the memory for the global datas is being freed by
  86.             the OS.
  87.  
  88.     SeekSame is very successful on harddisks with many icons or
  89.     other files of the same kind. On my 120 MByte harddisk SeekSame
  90.     could free 5 MByte superfluous data.
  91.  
  92.  
  93.      PARAMETERS
  94.  
  95.     DIR/A - the directory with optional search pattern to search in.
  96.         If you want to keep backup files, use '~(#?.bak)'. The
  97.         directory parameter _must_ be given.
  98.  
  99.     ALL/S - if this keyword is given all subdirectories are
  100.         processed as well.
  101.  
  102.     DEL/S - if this keyword is given, all redundant files are
  103.         deleted but one.
  104.  
  105.     MAKELINK/S - with this keyword SeekSame deletes all redundant
  106.         files and creates hardlinks instead. This option
  107.         is propably the most interesting one.
  108.  
  109.     QUIET/S - with this keyword you tell SeekSame, that you don't
  110.         waht to be nerved with superfluous information.
  111.  
  112.     VERBOSE/S - this keyword forces SeekSame to print very
  113.         superfluous information like the filesize of each file.
  114.  
  115.  
  116.      RESULT
  117.  
  118.     The statistics contain the total number of processed files,
  119.     the total number of processed bytes, the number of deleted
  120.     files and the sum of freed bytes followed by the value of
  121.     the possible freeable bytes.
  122.  
  123.     The best thing: some MByte free harddisk storage without
  124.     direct disadvantages.
  125.  
  126.  
  127.      NOTICES
  128.  
  129.     For a big number of files SeekSame needs more memory. Out of that,
  130.     the freeing of the resources takes longer (Cleanup).
  131.  
  132.     When you're working with a big depth of subdirectories you
  133.     should use a big stack (>=20 kB).
  134.  
  135.     The algorithm works with a method that's been invented by me
  136.     and is very fast. Though, you should have a big cup of coffee
  137.     when you're processing a big harddisk.
  138.  
  139.  
  140.      BUGS
  141.  
  142.     None known.
  143.  
  144.  
  145.      AUTHOR
  146.  
  147.     Stephan Fuhrmann
  148.     Ostmarkstraße 19
  149.     76227 Karlsruhe
  150.     GERMANY
  151.  
  152.     e-mail: Stephan.Fuhrmann@stud.uni-karlsruhe.de
  153.